home *** CD-ROM | disk | FTP | other *** search
/ Complete Linux / Complete Linux.iso / docs / apps / database / postgres / postgre2.z / postgre2 / ref / postquel / move < prev    next >
Encoding:
Text File  |  1992-08-27  |  1.4 KB  |  62 lines

  1. .\" XXX standard disclaimer belongs here....
  2. .\" $Header: /private/postgres/ref/postquel/RCS/move,v 1.4 1992/07/14 05:54:17 ptong Exp $
  3. .SP MOVE COMMANDS 6/14/90
  4. .XA 2 Move
  5. .uh NAME
  6. .lp
  7. move \*- move the pointer in a portal
  8. .uh SYNOPSIS
  9. .lp
  10. .(l
  11. \fBmove\fR [ ( \fBforward\fR | \fBbackward\fR ) ]
  12.     [ ( number | \fBall\fR | \fBto\fR ( number | record_qual ) ) ]
  13.     [ \fBin\fR portal_name ]
  14. .)l
  15. .uh DESCRIPTION
  16. .lp
  17. .b Move
  18. allows a user to move the
  19. .i "instance pointer"
  20. within the portal named
  21. .i portal_name .
  22. Each portal has an instance pointer,
  23. which points to the previous instance to be fetched.
  24. It always points to before the first instance when the portal is first created.
  25. The pointer can be moved
  26. .i forward
  27. or
  28. .i backward .
  29. It can be moved to an absolute position or over a certain distance.
  30. An absolute position may be specified by using
  31. .b to;
  32. distance is specified by a
  33. number.
  34. .i Record_qual
  35. is a qualification with no instance variables,
  36. aggregates,
  37. or set expressions
  38. which can be evaluated completely on a single instance in the portal.
  39. .uh EXAMPLE
  40. .lp
  41. .nf
  42. .ft C
  43. /* Move backwards 5 instances in the portal FOO */
  44.  
  45. move backward 5 in FOO
  46.     
  47. /* Move to the 6th instance in the portal FOO */
  48.  
  49. move to 6 in FOO
  50. .ft
  51. .fi
  52. .uh "SEE ALSO"
  53. .lp
  54. retrieve(commands),
  55. fetch(commands),
  56. close(commands).
  57. .uh BUGS
  58. .lp
  59. This command is not yet available.  The pointer may be moved using the
  60. .b fetch
  61. command, and ignoring its return values.
  62.